home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Just Call Me Internet
/
Just Call Me Internet.iso
/
com
/
othernet
/
mausnet
/
kaklo107
/
katzklo.dok
< prev
next >
Wrap
Text File
|
1995-02-05
|
42KB
|
983 lines
K a t z e n k l o
Ein Laberfilter fr den MausTausch
(ATARI-Version, OS/2-Version)
Version 1.07 vom 05. Februar 1995
(c) 1993-1995 Thomas Neumann
Gemeinsame Dokumentation
fr die ATARI- und OS/2-Version
===========================================================================
I n h a l t s b e r s i c h t
===========================================================================
0. Vorbemerkung zu dieser Dokumentation
1. Laberfilter/KATZENKLO
2. Funktionenbersicht
3. Aufruf/Installation
3.1 Im allgemeinen
3.2 Kommandozeilen-Optionen
3.3 Installation der ATARI-Version unter CAT als I/O-Filter
4. Filter-Konfiguration -- Die Datei KATZKLO.DAT
4.1 Kommandos
4.2 Filtermodi
4.3 Beispiel-Konfigurationen
5. Disclaimer
6. Lieferumfang
7. Nutzungsbedingungen/Copyright
===========================================================================
0. Vorbemerkung
===========================================================================
Seit dieser Version 1.07 gibt es KATZENKLO als ATARI- und OS/2-Version.
Diese Dokumentation beschreibt beide Versionen. Auf die jeweiligen
Unterschiede und Besonderheiten wird an den entsprechenden Stellen
hingewiesen.
===========================================================================
1. Laberfilter
===========================================================================
Ein Laberfilter dient dazu, Nachrichten, die Sie im MausTausch in ihrem
Outfile erhalten haben, in Abhngigkeit von gewissen Kriterien auszufiltern
und nicht (oder verndert) in die Datenbank ihres Frontends zu bernehmen.
Das kann zum einen den Grund haben, da Sie -- wie z.B. in der MAUS-Gruppe
"MausTausch" blich -- Nachrichten mit bestimmen Betreffkrzeln oder
Nachrichten zu gewissen Themen nicht lesen wollen, zum anderen knnen Sie
dadurch aber auch notorischen "Laberkppen" den Einzug in Ihre Nachrichten-
Datenbank verwehren.
Mit KATZENKLO knnen Sie fr jede MAUS-Gruppe -- auch fr die Gruppe der
persnlichen Mitteilungen (PM) -- verschiedene Kriterien angeben, anhand
derer entschieden wird, ob eine Nachricht verndert oder unverndert ins
Outfile bernommen wird oder ob die Nachricht entfernt wird.
===========================================================================
2. Funktionenbersicht
===========================================================================
KATZENKLO kann Nachrichten entweder komplett aus dem Outfile entfernen, mit
bestimmen Status-Flags versehen (etwa mit 'Gefiltert' -- solche Nachrichten
werden zwar in die Datenbank bernommen, je nach Konfiguration des
Frontends aber nur auf besonderen Wunsch angezeigt) oder Nachrichten in
andere Gruppen verschieben bzw. kopieren.
Fr jede MAUS-Gruppe -- auch fr die Gruppe der persnlichen Mitteilungen
(PM) -- knnen Sie Kriterien festlegen, anhand derer entschieden wird, was
mit einer Nachricht geschieht. Auerdem knnen Sie auch Kriterien
angeben, die fr Nachrichten in allen Gruppen gelten.
Solche Kriterien knnen Betreff, Absender, Empfnger, Inhalt (Text) der
Nachricht sowie die Tatsache, ob es sich bei einer Nachricht um einen
Kommentar auf eine andere Nachricht handelt oder nicht sein.
Alle Nachrichten, die KATZENKLO vollstndig aus dem Outfile entfernt, knnen
Sie in einer Filterdatei sammeln. Diese Datei hat das gleiche Format wie
ein Outfile. Im Zweifelsfalle knnen Sie die Filterdatei in OUTFILE.TXT
umbenennen und von Ihrem Frontend einfgen lassen knnen.
Auerdem kann KATZENKLO Footer an Tearlines entfernen. Die entfernten
Footer werden auf Wunsch ebenfalls in einer Datei gesammelt oder aber in
eine neue Gruppe umgelenkt -- selbstverstndlich mit gruppenbergreifender
Kommentarverkettung zur Originalnachricht. Einzelne Gruppen knnen von der
Tearlinebearbeitung ausgeschlossen werden, d.h. von Nachrichten dieser
Gruppe wird dann kein Footer entfernt.
Der Programmablauf wird auf Wunsch auf dem Bildschirm oder in einer Datei
(Logfile) protokolliert, so da Sie auch nachher ggf. noch den erkennen
knnen, welche Nachricht wie bearbeitet wurde.
Die ATARI-Version von KATZENKLO lt sich auch in einem I/O-Filter-Slot von
CAT (in registrierten CAT-Versionen ab 2.5 vorhanden) verwenden. Auch fr
DOT soll es ein Tool geben, das Filterslots nachahmt.
(Mglicherweise gilt hnliches fr OS/2-Frontends. Leider habe ich darber
keinen berblick. Wer mehr dazu wei, mge mir bitte schreiben.)
===========================================================================
3. Aufruf / Installation
===========================================================================
---------------------------------------------------------------------------
3.1. Im allgemeinen
---------------------------------------------------------------------------
KATZENKLO bearbeitet Outfiles, die Sie von ihrer MAUS erhalten haben,
bevor diese von ihrem Frontend eingefgt werden. Sie mssen KATZENKLO
also nach dem Auspacken des Outfiles (bzw. nach dem Tausch, sofern Sie
ungepackt tauschen) und vor dem Einfgen des Outfiles durch ihre Frontend
aufrufen. Dies kann automatisch in einem Batch geschehen.
KATZENKLO erwartet auf der Kommandozeile einige Optionen, die je nach
Bedarf angegeben werden knnen, aber nicht mssen, und den Namen des
Outfiles (evtl. mit Zugriffspfad), das bearbeitet werden soll.
(Mit der Option '-t' kann die Angabe des Outfiles entfallen, siehe dort.)
KATZENKLO verweigert seinen Dienst, wenn es keine Konfigurationsdatei
findet, wenn ungltige Optionen angegeben wurden oder wenn (auer mit
Option '-t') das angegebene Outfile nicht vorhanden ist. Enthlt die
Konfigurationsdatei Fehler, so wird das Outfile NICHT bearbeitet.
KATZENKLO sucht nach dem Start im aktuellen Verzeichnis nach der Datei
KATZKLO.DAT (sofern keine andere Konfigurationsdatei angegeben wurde,
siehe unter Kommandozeilen-Optionen), die die Filterkonfiguration
enthlt. Den Aufbau dieser Datei beschreibt Kapitel 4.
---------------------------------------------------------------------------
3.2. Kommandozeilen-Optionen
---------------------------------------------------------------------------
Vor (!) der Angabe des Outfiles knnen Sie einige Optionen auf der
Kommandozeile angeben, die jeweils mit einem Minuszeichen (-) eingeleitet
werden. Im einzelnen:
Option Bedeutung
v Der Programmablauf wird auf dem Bildschirm protokolliert. Zusammen
mit der Option "-t" erreichen Sie, da die Konfig-Datei geladen und
deren Auswertung durch KATZENKLO angezeigt wird.
h KATZENKLO wartet auf einen Tastendruck vor dem Programmende.
b Das Outfile-Backup wird nach erfolgreichem Filtern (und nur dann!)
gelscht. (Angabe zusammen mit Option -t ist unsinnig.)
l <Dateiname>
Hierber wird eine Datei (Logfile) angegeben, in der KATZENKLO alle
Aktionen protokolliert (empfohlen!). Ist diese Option nicht
angegeben, wird kein Logfile angelegt.
(ber den Aufbau des Logfiles sollte man besser keine Annahmen
machen; das gilt insbesondere fr Programme, die das Logfile
bearbeiten wollen. In jedem Fall behalte ich mir nderungen daran
vor.)
d <Dateiname>
Konfigurationsdatei explizit angeben: KATZENKLO sucht dann nicht
im aktuellen Verzeichnis nach der Datei KATZKLO.DAT, sondern
verwendet die als <Dateiname> angegebene Datei (die auch einen
Zugriffspfad enthalten darf).
t Konfigurationstest. KATZKLO.DAT wird gelesen und interpretiert,
fehlerhafte Zeilen werden moniert und die Gesamtzahl der Warnungen
und Fehler ausgegeben. Ist zustzlich die Option "-v" angegeben,
so wird interpretierte Konfiguration auch auf den Bildschirm und
ggf. ins Logfile ausgegeben.
Ist diese Option angegeben, wird lediglich die Konfiguration
getestet, ein Outfile wird NICHT bearbeitet und braucht auch nicht
angegeben zu werden.
Sie knnen KATZENKLO also folgendermaen aufrufen (die Angaben in eckigen
Klammern sind jeweils optional):
katzklo [-v] [-b] [-h] [-d <Dateiname>] [-l <Dateiname>] <Outfile>
oder:
katzklo -t [-v] [-h] [-d <Dateiname>] [-l <Dateiname>]
Mehrere Optionen knnen zusammengefat werden (z.B. -vhb).
Beispiel:
Mit der Kommandozeile
-vhb -d H:\KLO.DAT -l D:\DATABASE\KATZKLO.LOG E:\IMPORT\OUTFILE.TXT
gibt KATZENKLO whrend des Programmlaufs Informationen auf den Bildschirm
aus, wartet vor dem Programmende auf einen Tastendruck, lscht nach
erfolgreicher Bearbeitung das Outfile-Backup und verwendet "H:\KLO.DAT" als
Konfigurationsdatei. In der Datei KATZKLO.LOG im Verzeichnis "D:\DATABASE"
werden die Aktionen von KATZENKLO protokolliert.
---------------------------------------------------------------------------
3.3. Installation der ATARI-Version unter CAT als I/O-Filter
---------------------------------------------------------------------------
Wenn Sie CAT in einer registrierten Version ab 2.5 benutzen, knnen und
sollten Sie KATZENKLO in einem der I/O-Filter von CAT installieren. CAT
ruft dann vor dem Einfgen automatisch KATZENKLO auf. KATZENKLO ist als
I/O-Filter "fr Outfiles" zustndig -- dies mssen Sie in der
entsprechenden CAT-Dialogbox einstellen.
Auf der Kommandozeile geben Sie in CAT als Namen des Outfiles einfach nur
$I$O (ohne Space zwischen $I und $O!) fr den Outfile-Filter ein -- beim
Aufruf von KATZENKLO setzt CAT die richtigen Daten fr den Pfad- und
Dateinamen des Outfiles ein. Wie man im Detail einen I/O-Filter in CAT
installiert entnehmen Sie bitte der Anleitung zu CAT.
Wird KATZENKLO von CAT als I/O-Filter gestartet, so ist das aktuelle
Verzeichnis jenes Verzeichnis, in dem sich das ausfhrbare Programm
(KATZKLO.TTP) befindet. In diesem Verzeichnis wird auch KATZKLO.DAT gesucht.
Will man die Bildschirmausgaben (vgl. Option -v) von KATZENKLO whrend des
Filterns sehen, mu in CAT "Packerausgabe umlenken" abgeschaltet sein (zu
finden im Menu unter Optionen/Allgemein...).
Wenn Sie ein Logfile anlegen lassen, knnen Sie dies als Infotext in CAT
anmelden (wie das geht, lesen Sie bitte in der CAT-Anleitung). Achten
Sie darauf, da "MAUS-Infodatei" ausgeschaltet (nicht angekreuzt) ist.
Beispiel:
Wenn Sie als I/O-Filter-Kommandozeile
-vb -l $DKATZKLO.LOG $I$O
angeben, so gibt KATZENKLO whrend des Programmlaufs Informationen auf den
Bildschirm aus (nur sichtbar, wenn "Packerausgabe umlenken" ausgeschaltet
ist), lscht nach der erfolgreicher Bearbeitung das Outfile-Backup und
protokolliert seine Aktionen in der Datei KATZKLO.LOG im CAT-DATABASE-
Verzeichnis. Als Konfigurationsdatei wird KATZKLO.DAT verwendet, die sich
dort befindet mu, wo auch KATZKLO.TTP zu finden ist.
(Dies ist die empfohlene Konfiguration.)
===========================================================================
4. Filter-Konfiguration -- Die Datei KATZKLO.DAT
===========================================================================
Zum Programmstart erwartet KATZENKLO im aktuellen Verzeichnis die Datei
KATZKLO.DAT, der es die Filtereinstellungen entnimmt. (Anmerkung: Name
und Pfad der Konfigurationsdatei lt sich auch ber die Kommandozeilen-
Option '-d' festlegen. Im folgenden wird davon ausgegangen, da die
Konfig-Datei KATZKLO.DAT heit.)
KATZKLO.DAT ist eine Textdatei, die Sie mit einem Texteditor bearbeiten
knnen. In jeder Zeile darf ein Kommando stehen. Leerzeilen werden
berlesen, ebenso Zeilen, die mit einem '#' beginnen (Kommentarzeilen).
Hinter einem Kommando kann mit '#' ein Zeilenkommentar angegeben werden.
Alle Zeichen bis zum Zeilenende werden dann ignoriert.
Alle Kommandos mssen mit einem Semikolon (';') abgeschlossen sein. Einige
Kommandos bentigen ein Argument, das hinter einem Gleichheitszeichen ('=')
angegeben werden mu. Die Syntax ist also
Kommando;
bzw.
Kommando=Argument;
Leerzeichen (Spaces) am Zeilenanfang sowie links und rechts von
Kommandonamen werden grundstzlich nicht beachtet (Leerzeichen im Argument
werden natrlich beachtet!); zwischen Gro-und Kleinschreibung wird bei den
Kommandos nicht unterschieden.
KATZENKLO verweigert seinen Dienst, wenn in der Konfiguartionsdatei ein
Fehler erkannt wird. In diesem Fall wird eine detaillierte Fehlermeldung
unter Angabe der Zeilennummer, in der der Fehler auftrat, ausgegeben.
In aller Deutlichkeit: Ein Outfile kann NICHT bearbeitet werden, solange
die Konfig-Datei einen Fehler enthlt!
Erscheint lediglich eine Warnung, so wird das Outfile zwar bearbeitet,
dennoch sollte man der Ursache auf den Grund gehen.
Es ist ratsam, nach einer nderung der Konfig-Datei diese von KATZENKLO
testen zu lassen (siehe Option "-t") und zu prfen, ob Fehler enthalten
sind; diese sind dann ggf. zu berichtigen.
Eine Zeile in der Konfigurationsdatei KATZKLO.DAT darf maximal 255 Zeichen
lang sein.
Dem Archiv liegt eine kommentierte Beispielkonfiguration KATZKLO.DAT bei.
---------------------------------------------------------------------------
4.1. Kommandos
---------------------------------------------------------------------------
Folgende Kommandos stehen zur Verfgung, die am Anfang einer Zeile in der
Datei KATZKLO.DAT stehen drfen:
Kommando Kurze Beschreibung
Gruppe= Gruppe auswhlen, fr die die nachfolgenden
Filterkriterien gelten
Alle; Kriterien fr alle Gruppen festlegen
Betreff= Betreff-Kriterium angeben
Name= Absender-Kriterium angeben
Von= (vllig gleichwertig zu "Name=")
Text= Nachrichtentext-Kriterium angeben
An= Empfnger-Kriterium angeben
Kommentar; Kriterium, ob es sich bei einer Nachricht um einem
Kommentar auf eine andere Nachricht handelt.
FilterFile= Datei, in die die entfernten Nachrichten gelangen
Tearline= Muster fr Tearlines, an denen Footer entfernt
werden sollen
TearlineFile= Datei, in der die entfernten Footer gesammelt werden
TearlineGruppe= (neue) Gruppe, in die entfernte Footer gelenkt werden
TearlineMax= Anzahl der Zeilen des lngsten Footers festlegen, der
entfernt werden darf (die Tearline zhlt mit!)
FilteredAreRead; legt fest, ob gefilterte Nachrichten auch 'Gelesen' sind
(Anmerkung: In frheren Version wurde dieses Verhalten
ber Kommandozeilenoption "-G" gesteuert.)
sowie verschiedene Kommandos zur Festlegung von Filter- oder
Vergleichsmodus, etc., die im jeweiligen Kontext erklrt werden.
Kommando "Gruppe="
------------------
Syntax: Gruppe=<Gruppenname>; [NoTearline;] [<Filtermodus>;]
Mit diesem Kommando whlen Sie eine Gruppe aus, fr die die nachfolgenden
Filterkriterien (bis zum nchsten "Gruppe=" oder bis "Alle;") gelten. Fr
<Gruppenname> geben Sie den Namen der gewnschten MAUS-Gruppe an.
Der unter "Gruppe=" angegebene Name wird immer in voller Lnge, jedoch
ohne Beachtung von Gro-/Kleinschreibung, mit dem Gruppennamen im Outfile
verglichen! "Gruppe=Maus;" whlt wirklich nur die Gruppe "Maus" aus und
nicht zustzlich auch noch "Maus.Grp", "Mausbau", "MausTausch",
"Maus.Doku", etc.
Sie knnen auch in den persnlichen Mitteilungen filtern. Der
Gruppenname mu dann "Persnliche" (oder auch "Persoenliche") heien.
Die mglichen Angaben fr <Filtermodus> sind im folgenden Abschnitt
angegeben. Fehlt diese Angabe, so wird "Off" angenommen.
(Der Filtermodus kann auch fr jedes Kriterium einzeln festgelegt werden,
so da einzelne Kriterien eine andere Aktion bewirken knnen, als unter
"Gruppe=" festgelegt. Der bei einem Kriterium angegebene Filtermodus
hat Vorrang vor dem Gruppen-Filtermodus.)
Ist bei einem "Gruppe="-Kommando der Filtermodus "On" angegeben, folgen
jedoch keine Kriterien, so wird eine Warnung ausgegeben, denn es werden
alle Nachrichten dieser Gruppe entfernt.
Persnliche Nachrichten knnen, auch mit Filtermodus "Off", nicht aus dem
Outfile entfernt werden. Sie bekommen statt dessen das Flag
"Totallschung", so da sie beim nchsten Putz der Nachrichtendatenbank
entfernt werden.
Anmerkung: Fr jede MAUS-Gruppe darf hchstens ein "Gruppe="-Block
in KATZKLO.DAT enthalten sein. Bei mehreren gleichen Gruppen wird
eine Fehlermeldung ausgegeben.
Kommandos "Betreff=", "Name=", "Text=", "An=", "Kommentar;" (Kriterien)
------------------------------------------------------------------------
Syntax:
Name=<Vergleichstext>; [<Vergleichsmodus>;] [Case;] [Bis=<Datum>;] [<Filtermodus>;]
Von=<Vergleichstext>; [<Vergleichsmodus>;] [Case;] [Bis=<Datum>;] [<Filtermodus>;]
Betreff=<Vergleichstext>; [<Vergleichsmodus>;] [Case;] [Bis=<Datum>;] [<Filtermodus>;]
Text=<Vergleichstext>; [<Vergleichsmodus>;] [Case;] [Bis=<Datum>;] [<Filtermodus>;]
An=<Vergleichstext>; [<Vergleichsmodus>;] [Case;] [Bis=<Datum>;] [<Filtermodus>;]
Kommentar; [Bis=<datum>;] [<Filtermodus>;]
Nach einem "Gruppe="-Kommando knnen Sie die Kriterien fr diese Gruppe
mit den oben genannten Kommandos festlegen. "Name=" (gleichbedeutend mit
"Von=") vergleicht den angegeben Vergleichstext mit dem Absender einer
Nachricht, "Betreff=" mit der Betreffzeile, "An=" mit dem Empfnger;
"Text=" durchsucht den gesamten Nachrichtentext. "Kommentar;" trifft zu,
wenn es sich bei der Nachricht um einen Kommentar auf eine andere
Nachricht handelt.
Geben Sie als <Vergleichstext> einen Text an, der im Betreff, Absender,
Nachrichtentext, oder Empfnger einer Nachricht vorkommen soll.
Leerzeichen (Spaces) im Vergleichstext (nach dem Gleichheitszeichen ('=')
und vor dem Semikolon (';')) werden beachtet! Das Semikolon selbst kann
aus Syntaxgrnden nicht im Vergleichstext enthalten sein.
KATZENKLO sucht den Vergleichstext in der Nachricht standardmig als
Teil-String. Dieses Verhalten kann man mit Angabe eines anderen
<Vergleichsmodus> ndern. Erlaubt sind: "Anfang;", "Wort;" und "Ganz;".
"Anfang;" bewirkt, da der im Kriterium angegebene Vergleichstext am
Anfang der Zeile stehen mu, damit es zu einer bereinstimmung kommt. Mit
"Wort" kann man erreichen, da der Vergleichstext als eigenes Wort und
nicht als Teil eines anderen Wortes enthalten sein mu. Wortbegrenzer sind
die Zeichen
.-,:;?!"`'^$%&~|+@<>()[]{}\/*_#; sowie das Leerzeichen.
"Ganz" erfordert Gleichheit ber die gesamte Zeilenlnge.
Alle Vergleiche finden in KATZENKLO normalerweise case-insensitiv, d.h.
ohne Beachtung von Gro- und Kleinschreibung statt (gilt auch fr die
Umlaute!).
Mit dem Schalter "Case" wird ein case-sensitiver Vergleich (also mit
Bercksichtigung der Gro-/Kleinschreibung) des Vergleichtextes mit dem
entsprechenden Text in der Nachricht erzwungen.
Bei allen Vergleichen werden die deutschen Umlaute () und ihre
ent-umlautete Form (also "ae" fr "") als gleich betrachtet. Analoges
gilt fr das "scharfe s" ("ss" fr ""). Im einzelnen:
Umlaut ist bei Vergleichen identisch zu
AE oder Ae
OE oder Oe
UE oder Ue
ae
oe
ue
ss
Mit dem "Bis="-Kommando knnen alle Kriterien zeitlich befristet werden.
Das Datum <datum> kann in der Form TT.MM.JJ oder TT.MM.JJJJ eigegeben
werden; Tag und Monat auch einstellig (z.B. 26.6.) oder mit fhrender Null
(z.B. 01.07.). Fr die Jahreszahl sind die Werte 90..99 oder 1990..1999
erlaubt. Fehlerhafte Daten werden abgelehnt (siehe Fehler in der Konfig-
Datei).
Das Datum gilt einschlielich, Kriterien mit "Bis=17.9.95" werden also am
17.9. noch bercksichtigt und ab dem 18.9.95 abgelehnt.
Enthlt die Konfig-Datei ein abgelaufenes Kriterium, so wird eine Warnung
ausgegeben; das betreffende Kriterium wird dann beim Filtern nicht weiter
beachtet.
Mageblich fr den Datumsvergleich ist das Systemdatum Ihres Rechners,
nicht das Erstelldatum einer Nachricht.
Die mglichen Angaben fr <Filtermodus> sind im folgenden Abschnitt
beschrieben. Fehlt diese Angabe, so richtet sich die Bedeutung des
Kriteriums nach dem unter "Gruppe=" festgelegten Filtermodus. (Der bei
einem Kriterium angegebene Filtermodus hat im jedem Fall Vorrang vor dem
Gruppen-Filtermodus.)
Die Reihenfolge der Kommandos nach einem Kriterium spielt keine Rolle.
Es ist also egal, ob Sie z.B. "Wort;Bis=12.05.1995;Filter;" oder lieber
"Filter;Wort;Bis=12.5.95;" schreiben.
Die Kriterien werden immer in der Reihenfolge bewertet, in der sie in der
Konfigurationsdatei KATZKLO.DAT stehen. Damit kann man erreichen, da
eine Nachricht, die aufgrund des einen Kriteriums mglicherweise
ausgefiltert wrde, aufgrund eines spteren Kriteriums doch noch im
Outfile verbleibt. Natrlich ist auch der umgekehrte Vorgang denkbar.
Kommando "Rest;"
----------------
Syntax:
Rest;<Filtermodus>;
Mit dem Kommando "Rest;", welches hchstens einmal innerhalb eines GRUPPE-
Blocks auftreten darf, kann man explizit angeben, was mit Nachrichten, die
auf keines der angegebenen Kriterien passen, passieren soll.
Die mglichen Angaben fr <Filtermodus> sind im folgenden Abschnitt
beschrieben. Die Angabe des Filtermodus hinter "Rest;" darf nicht fehlen.
Sollen Nachrichten, die auf ein Kriterium passen, im Outfile bleiben, der
Rest das das 'Gefiltert'-Flag bekommen, so kann man
Gruppe=Biete; On;
Rest; Filter;
Name=...;
Betreff=...;
# und so weiter.
verwenden.
Ist "Rest;" nicht angegeben, so wird "On" angenommen, sofern bei
"Gruppe=" nicht "On" angegeben wurde, denn dann wird fr Rest "Off"
angenommen.
Stimmen der Filtermodus bei "Gruppe=" und "Rest;" berein, wird eine
Warnung ausgegeben.
Kommando "Alle;"
----------------
Syntax: Alle; [<Filtermodus>;]
Kriterien, die fr alle Gruppen (Vorsicht: Auch fr die PMs!) gelten
sollen, knnen Sie nach dem Kommando "Alle;" angeben. Die bis zum
nchsten "Gruppe="-Kommando aufgefhrten Kriterien gelten dann fr alle
Gruppen.
Die mglichen Angaben fr <Filtermodus> sind im folgenden Abschnitt
angegeben. Fehlt diese Angabe, so wird "Off" angenommen.
Das "Alle;"-Kommando darf hchstens einmal in der Konfig-Datei vorkommen
(andernfalls enthlt man eine Fehlermeldung). Die Angabe des Kommandos
"Rest;" im ALLE-Block ist nicht erlaubt.
Die Kriterien nach "Alle;" werden auch auf Nachrichten aus Gruppen
angewendet, die keinen eigenen "Gruppe="-Eintrag in der Konfigurations-
datei haben. Die "Alle"-Kriterien werden immer zuletzt bewertet.
Der Filtermodus "On" hat hier eine leicht genderte Bedeutung: Mit
Kriterien fr "Alle" kann man dadurch keine Nachrichten ausschlieen (wie
in den explizit angegeben Gruppen), sondern nur Nachrichten, die aufgrund
anderer Kriterien zuvor aussortiert wurden, doch noch ins Outfile
bernehmen.
Auf Nachrichten aus Gruppen, die in der Konfigurationsdatei KLATZKLO.DAT
_nach_ dem "ALLE"-Block aufgefhrt sind, werden die ALLE-Kriterien nicht
angewendet. So lassen sich einzelne Gruppen (mglicherweise die Gruppe
'Persnliche') von der ALLE-Behandlung ausschlieen.
Kommando "FilterFile="
----------------------
Syntax: FilterFile=<Filename>;
Nachrichten, die komplett aus dem Outfile entfernt wurden, knnen in
dieser Datei im Outfileformat gesammelt werden. Wollen Sie die entfernten
Nachrichten spter doch noch in Ihre Nachrichten-Datenbank importieren,
benennen Sie die Datei einfach in OUTFILE.TXT um und fgen Sie dieses
Outfile ein. (Dabei sollten Sie KATZENKLO nicht aufrufen oder zumindest
die Konfiguration vorbergehend ndern -- sonst landen diese Nachrichten
wieder im Filterfile!)
Ist dieses Kommando in KATZKLO.DAT nicht enthalten, wird keine solche
Datei angelegt.
Kommando "Tearline="
--------------------
Syntax: Tearline=<Tearline>;
KATZENKLO kann (lstige?) Footer von Nachrichten an sogenannten Tearlines
entfernen. Eine Tearline ist eine Zeile, die genau den nach "Tearline="
angegebenen Text, gefolgt von einem Zeilenende, enthlt. Sie drfen
beliebig viele "Tearline="-Kommandos angeben.
bliche Tearlines sind "---" oder "--". (Im UseNet ist "-- " recht
gebruchlich. Die MAUS schneidet Leerzeichen am rechten Zeilenrand
('trailing spaces') jedoch ab, so da "-- " zu "--" wird.)
KATZENKLO schneidet Footer an der letzten (untersten) mglichen Tearline
ab. Ist das Kommando "TearlineMax=" (siehe dort) angegeben, werden die
untersten unter TearlineMax angegebenen Zeilen nach einer Tearline
durchsucht, andernfalls der gesamte Nachrichtentext.
Footer von Nachrichten, die aus dem Outfile entfernt wurden, werden nicht
abgeschnitten und auch nicht in die TearlineGruppe umgelenkt oder ins
TearlineFile geschrieben.
Beispiel:
Tearline=---;
Tearline=--;
Die Zeile "---xxx\n" ist somit keine Tearline, weil nach den "---" die
Zeile noch nicht zu Ende ist. Gleiches gilt fr "----\n". Ebenso ist
" ---\n" keine Tearline. Lediglich "---\n" wird als Tearline
akzeptiert und zusammen mit dem nachfolgenden Text entfernt (die
Tearline wird also auch entfernt!) ["\n" reprsentiert hier das
Zeilenende-Zeichen].
Die in der Konfigurationsdatei angegebenen Tearlines gelten fr alle
Nachrichten mit Ausnahme der Nachrichten aus Gruppen, fr die die
Tearlinebehandlung ausgeschlossen wurde (Gruppe=...;NoTearline;).
Kommando "TearlineFile="
------------------------
Syntax: TearlineFile=<Filename>;
Footer, die KATZENKLO an Tearlines entfernt hat, knnen als Text in eine
Datei geschrieben werden, wenn solch eine Datei in KATZKLO.DAT
angegeben wurde. Zustzlich zum Footer-Text wird auch die Message-ID, der
Gruppenname, aus der die Nachricht stammt sowie der Absender in
diese Datei geschrieben.
Ist dieses Kommando in KATZKLO.DAT nicht enthalten, wird keine solche
Datei angelegt.
Kommando "TearlineGruppe="
--------------------------
Syntax: TearlineGruppe=<Gruppenname>;
Die von KATZENKLO entfernten Footer knnen Sie auch in einer anderen,
hier anzugebenden Gruppe in ihr Frontend importieren. Wird als
Gruppenname beispielsweise "Footer" gewhlt, so landen alle Footer aus
allen Gruppen in dieser (neuen) Gruppe "Footer", die natrlich nur in
Ihrem Frontend existiert. Die Nachrichten in dieser Gruppe sind mit
einer gruppenbergreifenden Kommentarverkettung versehen, so da Sie
schnell zur Ursprungsnachricht zurckfinden knnen.
Whlen Sie am besten einen Gruppennamen, den es in der MAUS nicht gibt.
"Footer" oder "Tearlines" halte ich in dieser Beziehung fr ziemlich
unproblematisch. Die Tearlinegruppe darf nicht "Persnliche" o.. heien.
Ist dieses Kommando in KATZKLO.DAT nicht enthalten, werden die evtl.
abgeschnittenen Footer nicht in eine andere Gruppe umgelenkt.
Anmerkung: Ist "TearlineGruppe=" angegeben, werden von Nachrichten aus
dieser Gruppe keine Tearlines entfernt.
Kommando "TearlineMax="
-----------------------
Syntax: TearlineMax=<Zeilenzahl>;
Hiermit kann die Lnge des lngsten Footers, der entfernt werden soll,
festgelegt werden; lngere Footer werden nicht entfernt (die Tearline
zhlt bei der Lngenberechnung mit!).
Dies kann verhindern, da Nachrichten nahezu komplett entfernt werden,
weil der Schreiber irgendwo ganz oben eine "---"-Zeile eingegeben hat.
Beispiel:
TearlineMax=12;
Kommando "FilteredAreRead;"
---------------------------
Syntax: FilteredAreRead; [ {On|Off} ; ]
Nachrichten, die aufgrund des Filtermodus "Filter;" das 'Gefiltert'-Flag
bekommen, knnen auch gleichzeitig mit dem 'Gelesen'-Flag markiert werden.
Das Verhalten, ob gefilterte Nachrichten als gelesen gelten oder nicht,
kann mit diesem Kommando festgelegt werden. Erlaubt sind "On" oder "Off".
Ist das Kommando nicht angegeben, wird "On" angenommen ('Gefilterte' sind
dann 'Gelesen').
Dieses Kommando darf in der Konfig-Datei hchstens einmal vorkommen.
---------------------------------------------------------------------------
4.2. Filtermodi
---------------------------------------------------------------------------
Bei den Kommandos "Gruppe=", "Rest;", "Alle;" und einigen Kriterien
(Betreff=", Name=", etc.) kann ein Filtermodus angegeben werden. Dieser
bestimmt, was mit einer Nachricht, die auf eines der Kriterien zutrifft,
geschieht. Im folgenden werden die mglichen Filtermodi erlutert:
Filtermodus O F F
------------------
Eine Nachricht, auf die ein Kriterium mit dem Filtermodus OFF zutrifft,
wird aus dem Outfile entfernt.
Filtermodus O N
----------------
Eine Nachricht, auf die ein Kriterium mit dem Filtermodus ON zutrifft,
verbleibt im Outfile.
Filtermodus F I L T E R
------------------------
Eine Nachricht, auf die ein Kriterium mit dem Filtermodus FILTER zutrifft,
verbleibt im Outfile, wird allerdings mit dem Status-Flag "Gefiltert"
versehen (ggf. auch mit "Gelesen", abhngig von "FilteredAreRead;").
Da dieses Flag frontendbergreifend festgelegt ist, wird dies in der ATARI-
und OS/2-Version untersttzt. Dieser Filtermodus kann jedoch nur
funktionieren, wenn Ihr Frontend diese Information ('s'-Zeile) im Outfile
auswertet (vgl. Anmerkung bei "Flags="). CAT kann das, von den OS/2-FEs
wei ich es nicht. Auch hier wre ich fr Informationen dankbar.
Filtermodus M O V E = <Gruppenname>
------------------------------------
Mit dem Filtermodus "Move=" knnen Nachrichten, die auf das betreffende
Kriterium passen, in die angegebene (Pseudo-) Gruppe umgeleitet werden.
Der Gruppenname darf nicht "Persnliche" o.. sein. KATZENKLO macht aus
einer ffentlichen Mitteilung KEINE persnliche Mitteilung.
Beim Verschieben wird in der ersten Zeile der Nachricht der Name der
Originalgruppe, so wie sie im Outfile stand, eingefgt. Enthlt die erste
Zeile der Nachricht eine Wildwest-Verkettung, so wird die Originalgruppe
in der zweiten Zeile eingefgt, um die Verkettung nicht zu zerstren.
Filtermodus C O P Y = <Gruppenname>
------------------------------------
ist vergleichbar mit dem Filtermodus "Move=", nur da hierbei die
Nachricht in der Originalgruppe erhalten bleibt und in der neuen Gruppe
eine zustzliche Nachricht erzeugt wird.
Wenn Sie gleichzeitig auch Footer entfernen und diese in eine eigene
Gruppe schreiben lassen, so wird dort nur EINE Footer-Nachricht erzeugt
(mit einer Verkettung zur Nachricht in der Originalgruppe). Der Footer
wird aber sowohl beim Original als auch bei der Kopie entfernt.
Filtermodus F L A G S
----------------------
Mit "Flags=" knnen Sie die Status-Flags (das sind 'Gelesen', 'Gefiltert',
'Totallschung', Userflags, etc.) setzen. Diese Funktion mu vom jeweils
verwendeten Frontend untersttzt werden, d.h. das Frontend mu die im
Outfile vorhandenen Status-Flags ('s'-Zeile) auswerten knnen.
Anmerkung:
Einige Flags sind in TAUSCHBAU frontendbergreifend festgelegt worden.
Die Auswertung der Flags obliegt letztendlich dem verwendeten Frontend.
Es ist also mglich, da gleiche Flags bei verschiedenen Frontends
verschiedene Wirkungen (zum Beispiel gar keine) zeigen.
Fr die ATARI-Version gilt:
Die Flags sind in der CAT-Notation anzugeben (die sich von der Darstellung
im Outfile und mglicherweise auch von anderen Frontends unterscheidet!).
Erlaubt sind die in der derzeit aktuellen CAT-Version 2.63 bekannten Flags
"LFITDKB12V"; andere Flags liefern eine Fehlermeldung.
Fr die OS/2-Version gilt:
Es knnen beliebige Flags angegeben werden. Sie werden unverndert ins
Outfile bernommen. Die Auswertung obliegt sowieso dem verwendeten
Frontend.
Gro- und Kleinschreibung wird bei den Flags unterschieden.
---------------------------------------------------------------------------
4.3. Beispiel-Konfigurationen
---------------------------------------------------------------------------
1. Mit folgender Konfiguration knnen Sie -- sofern Sie "Hein Bld @ IRQ"
heien -- Ihre eigenen Nachrichten in allen Gruppen mit den Flags
'Interessant' und 'Vererben' kennzeichnen (vgl. aber auch allgemeine
Anmerkung zu "Flags="):
ALLE;
Name=Hein Bld @ IRQ; Flags=IV;
2. Im folgenden Beispiel werden Footer an den angegebenen Tearlines
entfernt. Footer, die (inklusive Tearline) lnger als 8 Zeilen sind,
werden nicht entfernt. In der Gruppe "SuperTolleFooter" (knnte eine
lokale Gruppe sein, in der stndig nette Footer auftauchen) werden die
Footer nicht entfernt.
Tearline=---;
Tearline=--;
TearlineMax=8;
Gruppe=SuperTolleFooter; NoTearline;
3. Wenn Sie in der Gruppe Natur die Diskussion mit dem Betreff "Ameisen"
nicht interessiert, Sie diese Nachrichten aber nicht vllig entfernen
sondern als 'Gefiltert' markieren wollen, konfigurieren Sie
Gruppe=Natur;Filter;
Betreff=Ameisen;
oder aber (gleichwertig)
Gruppe=Natur;
Betreff=Ameisen;Filter;
4. Angenommen, ein User ist Ihnen sehr unangenehm aufgefallen, Sie wollen in
der Gruppe XYZ nichts mehr von ihm lesen. Weil Sie ein fairer Mensch
sind, wollen Sie ihm ab Weihnachten 1997 noch mal 'ne Chance geben:
Gruppe=XYZ; # wenn kein Filtermodus angegeben ist, gilt "Off"!
Name=Max Mustermann;Bis=24.12.97;
Pnktlich am 25.12.97 (vorausgesetzt, die Systemzeit Ihres Rechners
stimmt) wird dieses Kriterium dann nicht mehr beachtet (und KATZENKLO
gibt eine Warnung aus).
5. Von dem User aus Beispiel 4 wollen Sie eigentlich immer noch nichts
wissen, aber da Sie an Leberkndeln sehr interessiert sind, wollen Sie
keine Nachricht, in denen dieses magische Wort vorkommt, verpassen -- Max
Mustermann hin oder her. Als Kriterien geben Sie an:
Gruppe=XYZ;
Name=Max Mustermann;
Text=Leberkndel;On; # pat auch auf "Leberknoedel"!
Die Kriterien werden in der Reihenfolge bewertet, in der Sie sie
angegeben haben. Beachten Sie, da durch eine Volltextsuche (Kommando
"Text=") die Filterung deutlich lnger dauern kann.
6. Mit der folgenden Konfiguration wrden alle Nachrichten aus
der Gruppe MausTausch entfernt, deren Betreff mit "Min:" anfngt und die
Nachrichten, die ein "Amiga" im Betreff haben, bekommen das Flag
'Gefiltert' und gelangen ins Outfile. Alle Nachrichten, die ein
gewisser "Hans Haumichblau" (die hnlichkeit mit lebenden und
verstorbenen wre rein zufllig) verschickt hat, kommen immer
unverndert ins Outfile -- auch wenn ihr Betreff mit "Min:" anfngt und
auch, wenn er ein "Amiga" enthlt.
Gruppe=MausTausch;Off;
Betreff=Min:;Anfang;
Betreff=Amiga;Wort;Filter;
Name=Hans Haumichblau;On;
7. Die Nachrichten, die auf einen der Betreffs (oder der anderen mglichen
Kriterien) passen, bleiben in der Gruppe "Biete", alle anderen werden in
die Gruppe "Biete.Abfall" verschoben (sofern im einzelnen nichts anderes
angegeben ist oder eines der "ALLE"-Kriterien zum Zuge kommt).
Gruppe=Biete;On;
Rest; Move=Biete.Abfall;
Betreff=Atari;
Betreff=CD;Wort;
# und so weiter.
Weitere Beispiele finden Sie in der Konfigurationsdatei KATZKLO.DAT, die
diesem Archiv beiliegt.
===========================================================================
5. Disclaimer
===========================================================================
Zunchst einiges zum Programmablauf:
KATZENKLO legt zu Beginn eine Kopie des Outfiles an (genauer gesagt, es
benennt das Outfile in '*.KLO' um), das dann nur noch gelesen wird. Die
Ausgabe erfolgt dann in eine neue Datei mit dem ursprnglichen Namen des
Outfiles. (Ist die Extension des Eingabe-Outfiles bereits *.KLO, so hat das
Backup die Extension *.KL0.)
Auf Ihrer Festplatte sollte also mindestens noch einmal soviel Platz frei
sein sollte, wie das Outfile (ungepackt!) gro ist.
Geht irgendetwas bei der Bearbeitung durch KATZENKLO schief (z.B. weil kein
Platz mehr auf der Festplatte frei ist), benennt KATZENKLO das Outfile-
Backup wieder in seinen alten (originalen) Namen um und beendet sich.
Selbst bei mglichen schwerwiegenden Fehlern (wie z.B. Stromausfall whrend
des Filterns) sollten Sie immer noch das Outfile-Backup haben, so da keine
Nachrichten verloren gehen knnen. (Safety first!)
Eine Nachricht darf inklusive Header hchstens 32 kB gro sein und aus
hchstens 3000 Zeilen bestehen (reine Willkr).
KATZENKLO wurde sorgfltig entwickelt und getestet. Dennoch kann ich Fehler
nicht vllig ausschlieen. Die Benutzung dieses Programmes geschieht auf
eigene Gefahr! Ich bernehme keinerlei Haftung fr Schden, die direkt oder
indirekt aufgrund der Verwendung von KATZENKLO entstehen.
Was auch passiert: Sie sind selbst Schuld!
Wenn Sie glauben, einen Fehler gefunden zu haben, Anregungen, Wnsche oder
Ideen zur Weiterentwicklung haben, schreiben Sie mir bitte.
Bei Fehlermeldungen bitte ich um mglichst exakte Angaben. Dazu gehren in
jedem Fall der Inhalt Ihrer Konfigurationsdatei und ein Auszug aus Ihrem
Outfile, das die fehlerhaft behandelte(n) Nachricht(en) enthlt (den
Nachrichtentext knnen Sie gerne, soweit dies eine Reproduktion des Fehlers
zult, anomynisieren), auerdem das Logfile und das Filterfile.
Nur so kann ich den Fehler ggf. reproduzieren und beheben.
Sollten Sie trotz grndlicher Lektre der Anleitung auf unlsbare Probleme
stoen, lesen Sie die Dokumentation noch einmal. Hilft das nicht weiter,
fragen Sie in einer geeigneten Maus-Gruppe (MausTausch, MT.CAT,...) nach
oder schreiben Sie mir eine PM.
Die ATARI-Version wurde mit Pure C 1.1 entwickelt, die OS/2-Version mit
IBM CSet++ 2.01.
===========================================================================
6. Lieferumfang
===========================================================================
Das ZIP-Archiv enthlt folgende Dateien:
README.1ST -- Diese Datei sollten Sie zuerst lesen.
KATZKLO.TTP -- Programm (ATARI-Version, nur im ATARI-Archiv enthalten)
KATZKLO.EXE -- Programm (OS/2-Version, nur im OS/2-Archiv enthalten)
KATZKLO.DAT -- Beispiel-Konfiguration
KATZKLO.DOK -- Gemeinsame Dokumentation fr die ATARI- und OS/2-
Version -- Sie lesen sie gerade!
KATZKLO.CHG -- Beschreibung der nderungen/Neuerungen
seit der letzten ffentlichen Version 1.06
(nur im ATARI-Archiv enthalten, OS/2-Version ist
Erstverffentlichung)
KATZKLO.UPL -- Kurzbeschreibung fr den Upload in Programmteile
Eine Weitergabe ist nur erlaubt, wenn alle diese Dateien vollstndig und
unverndert weitergegeben werden. Sie sollten vorzugsweise das Original-
archiv weitergeben.
===========================================================================
7. Nutzungsbedingungen / Copyright
===========================================================================
Alle Rechte an KATZENKLO liegen beim Programmautor (Thomas Neumann).
Dieses Programm ist in der vorliegenden Version Freeware, das heit, Sie
drfen KATZENKLO frei und kostenlos benutzen.
Wenn Ihnen KATZENKLO gefllt oder Sie KATZENKLO regelmig benutzen, erbitte
ich von Ihnen eine Spende (Schokolade, Tullamore Dew, Gummibrchen, Geld,
<Denken-Sie-sich-was-aus!>... ), ber deren Ausma Sie selbst entscheiden
sollen (was ist Ihnen KATZENKLO wert?).
KATZENKLO darf nur unverndert und vollstndig, d.h. zusammen mit allen im
Lieferumfang enthaltenen Dateien, weitergeben werden (vorzugsweise als
Original-Archiv). Die Weitergabe hat ausschlielich kostenlos zu erfolgen
(z.B. ber Mailboxen des MausNets). Eine Verbreitung ber fr den Empfnger
gebhrenpflichtige Medien ist nicht zulssig, sondern bedarf meiner
vorherigen schriftlichen Zustimmung. Gleiches gilt fr den Vetrieb ber
Public-Domain-/Shareware-Disketten. Ich behalte mir vor, diese Regelungen
jederzeit ohne Angabe von Grnden zu widerrufen. Die Benutzung dieses
Programmes geschieht auf eigene Gefahr! Ich bernehme keinerlei Haftung fr
Schden, die direkt oder indirekt aufgrund der Verwendung von KATZENKLO
entstehen.
So erreichen Sie den Autor
(E-Mail bevorzugt, meine Postadresse wird sich wohl demnchst ndern):
Adresse: Thomas Neumann, Ostackerweg 48, D-47139 Duisburg
E-Mail: TN @ DU (MausNet; tn@du.maus.de von auerhalb),
oder: T.Neumann@uni-duisburg.de (Internet)
Ihre Geldspende berweisen Sie bitte auf mein Konto:
Bank: Kto 336-011200, Stadtsparkasse Duisburg, BLZ 350 500 00.
Duisburg, den 05. Februar 1995 --- Thomas Neumann